home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmTabListReplacePositions.z / XmTabListReplacePositions
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss - A convenience function that
  10.           creates a new tab list with replacement tabs
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss(
  15.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt oooollllddddlllliiiisssstttt,
  16.           CCCCaaaarrrrddddiiiinnnnaaaallll ****ppppoooossssiiiittttiiiioooonnnn____lllliiiisssstttt,
  17.           XXXXmmmmTTTTaaaabbbb ****ttttaaaabbbbssss,
  18.           CCCCaaaarrrrddddiiiinnnnaaaallll ttttaaaabbbb____ccccoooouuuunnnntttt);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss creates a new tab list that
  25.           contains the contents of _o_l_d_l_i_s_t, but with the tabs at the
  26.           positions in _p_o_s_i_t_i_o_n__l_i_s_t replaced with copies of the
  27.           corresponding tabs in _t_a_b_s.  A warning message is displayed
  28.           if a specified position is invalid; for example, if the
  29.           value is a number greater than the number of tabs in the tab
  30.           list.
  31.  
  32.           This function deallocates the original tab list after
  33.           extracting the required information. It is the caller's
  34.           responsibility to free the tabs in _t_a_b_s by using the
  35.           XXXXmmmmTTTTaaaabbbbFFFFrrrreeeeeeee function.
  36.  
  37.           _o_l_d_l_i_s_t   Specifies the tab list.  The function deallocates
  38.                     the tab list after extracting the required
  39.                     information.
  40.  
  41.           _p_o_s_i_t_i_o_n__l_i_s_t
  42.                     Specifies an array of positions of the tabs to be
  43.                     replaced. The position of the first tab is 0
  44.                     (zero), the position of the second tab is 1, and
  45.                     so on.
  46.  
  47.           _t_a_b_s      Specifies an array of the replacement tabs.
  48.  
  49.           _t_a_b__c_o_u_n_t Specifies the number of elements in _p_o_s_i_t_i_o_n__l_i_s_t
  50.                     and _t_a_b_s.
  51.  
  52.      RRRREEEETTTTUUUURRRRNNNN
  53.           If _t_a_b_s, _o_l_d_l_i_s_t, or _p_o_s_i_t_i_o_n__l_i_s_t is NULL, or _t_a_b__c_o_u_n_t is
  54.           0 (zero), returns _o_l_d_l_i_s_t. Otherwise, this function returns
  55.           the new tab list.  The function allocates space to hold the
  56.           returned tab list.  The application is responsible for
  57.           managing the allocated space.  The application can recover
  58.           the allocated space by calling XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEELLLLAAAATTTTEEEEDDDD
  75.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt(3).
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.